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PRIMER FOR OS- 3 USERS 



READ THIS PAGE FIRST 



Paragraph A: 

The material which follows is presented in a non-sequential order. 
You must follow the links from one paragraph to another. If you 
attempt to read straight through, you will undoubtedly get bogged 
down in some subjects that are of no interest to you. Paragraph 
numbers appear at the bottom of each page . 

For example, if you have understood the preceding three sentences, 
turn to paragraph 0, next page. Otherwise re-read paragraph A. 



Paragraph B: 

UNDER NO CIRCUMSTANCES SHOULD YOU BE READING THIS SENTENCE! Re-read 

paragraph A. 



0. 

This manual is intended for all new users of OS-3. 

OS- 3 is the operating system utilized by the OSU Computer Center *s 
CDC 3300 computer. If you know what an operating system is, skip to 
paragraph 2 . Otherwise read paragraph 1 . 



0. 



1. 



An "operating system" is a collection of programs that supervises 
the overall operation of a computer system. Most rankings or order- 
ings of the programs available to a particular computer would place 
the operating system first . Each user must first establish contact 
with the computer through the facilities of the operating system. 
For the case of OS-3, this is called "logging on" and is discussed 
in detail later. Each user must also conclude his run via 0S-3*s 
"LOGOFF" command, and, in the meantime, reach all other software by 
descending through 0S-3 f s "control mode." 



1. 



2. 



OS- 3 (Oregon State Open Shop Operating System) is a "time-sharing" 
system; that is, many users are able to use the resources of the sys- 
tem concurrently. For further details on system architecture see 
paragraph 46. Otherwise, note that OS-3 recognizes two fundamentally 
different types of users: 

" batch ", turn to paragraph 3 
and 

"on-line" , paragraph 4 . 



2. 



3. 

A "batch" user normally submits his job as a deck of punched cards to 
the personnel in the Computer Center I/O room (207). The deck is 
"batched" with those of other users, then read through the system 1 s 
card reader and processed in turn by the computer. In this mode, 
OS-3 normally reads input data from the card reader, and writes the 
user f s output on the high-speed line printer in the machine room. 
The deck and printed listing are later returned to the user by the 
I/O room personnel to complete the cycle. Turn-around time for this 
entire operation varies from about 30 minutes to 2+ hours, depending 
upon system load. 

****** For further information about running batch jobs, turn to ****** 

paragraph 9 



3. 



4. 

On-line users need not be near the Computer Center in Corvallis, but 
may utilize the computer's facilities from essentially any place that 
there is telephone service. A Teletype terminal may be used to com- 
municate with OS-3 over telephone lines. Establishing contact with 
GS-3 is called "logging on." In order to LOGON - either in a batch 
run or on-line - you must have a valid job number /user code combina- 
tion. 

****** t learn how to obtain a job number see paragraph 35 ****** 



****** p or a discussion of TV (CRT) terminal use, see para- ******* 

graph 7 

A description of logging on at a Teletype (TTY) follows. 
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5. 

To LOGON from a Teletype, first be certain that the MODE SELECT knob 
on the front right-hand corner of the machine is in "LINE" position. 
Then depress the "CNTL" key (leftmost key, third row from top) and 
the A key simultaneously. OS-3 will type its special symbol - the 
pound sign "#" and wait about 20 seconds for you to type your job 
number, a comma, and then your user code 5 followed by a carriage 
return (RETURN key, second key from right end of second row, referred 
to as "CR"). OS-3 will write masking characters over what you have 
typed so that no one can read your number, and then print the date, 
time, and your terminal number. (If, for any reason, you should 
need to contact the Computer Center regarding a problem with your 
run, you will need to know the number of your terminal.) While you 
are logged on you are charged $2 /hour for being connected to the 
computer — even if "ou do nothing more * 

If you made an error in typing your job number or user code, OS-3 
will still blot out what you typed, but will write "ILLEGAL JOB/USER 
NUMBER," then go away and ignore you. To try again, you must repeat 
the "CNTL-A U step. If you are a super-slow typer and nothing at all 
happens after you type carriage return (CR key), it ! s because more 
than 20 seconds elapsed between the CNTL-A and the CR key activations. 
Again you must start over with the CNTL-A step. (You will be amazed 
how fast your typing improves as you practice this way!) 
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6. 

Now that you are logged on, and are paying $2 /hour for the privilege, 
the question immediately arises, "How to LOGOFF?" Only OS-3 can log 
you on and only OS-3 can log you off. No subordinate software under- 
stands the meaning of the "LOGOFF" command or takes the proper action 
if given this command. So, in order to LOGOFF, you must be "in" 
0S-3*s control mode. To assure that you are in this state depress 
the two keys, CNTL and A together. OS-3 will type #. the pound 
sign is 0S-3 ! s trademark, and signifies that the control mode routine 
is ready to process a command, such as LOGOFF. If the last character 
typed was #, simply type "LOGOFF" followed by CR, and OS-3 will print 
a message telling how many seconds of actual computer time you have 
used (to the nearest millisecond), the maximum number of disk file 
blocks and the approximate cost of your run. 



JU «Xm «t» «3U *J» tfm 



****** See paragraph 37 for a discussion of disk storage and nn 

paragraph 36 for billing information 

To get into OS-3 control mode from any subordinate level, if the Tele- 
type is typing, depress the BREAK key. (Some models also have a BREAK 
RELEASE key.) If it is not typing, depress CNTL and A together, and 
again OS-3 will write its #. You then can LOGOFF as described above. 

Always be certain you are successfully logged off after each run. 
Also, turn the Teletype "MODE SELECT" knob from "LINE" to "OFF" to 
avoid unnecessary wear on motors, belts, etc. If there is any ques- 
tion about whether you are really off-the-air when you want to be, 
call or contact the I/O room personnel (75H-2033); but know your 
terminal number. 
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7. 

The Control Data 210 (TV or CRT) terminal communicates directly with 
the CDC 3300, transmitting up to 250 words - one screen full - of 
information each time the SEND key is activated. To LOGON at a CRT, 
clear the screen (clear key - upper leftmost key). Note that # is 
not a member of the character set for these devices. Use "j*" (upper 
case "7") as the substitute, and type this followed by your job 
number, a comma, your user code, and then a "SEND." If OS-3 regards 
your number favorably, it will clear the screen and write out the 
date, time, and terminal number. 

WARNING - If the computer is "down" the yellow light next to the key- 
board will stay on after you "SEND" and your job number and user code 
will remain on the CRT screen until you call 754-2033 and ask to have 
,./sim o^-m^iii-. nioanoH r\-n tho /->r>TYmi »+pr aptR wp.n . The wav to avoid this 
problem is to type s*,SEND before entering your job number. If OS-3 
is alive and well, it will write "ILLEGAL JOB/USER NUMBER." 
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8. 

You are in OS- 3 control mode whenever the i symbol appears in the 
upper lefthand corner of the screen, and the cursor (line position 
pointer) is under the t mark. To get into this configuration if you 
are not already there - so that you can LOGOFF, for example - clear 
the screen, type in upper case "7" (#) and press SEND. Whatever was 
running will be interrupted and you will be in OS-3 control mode. 
Typing "LOGOFF" and pressing SEND will take you off-the-air with a 
message about time and disk storage space used, and their monetary 
equivalent . 



8. 



9. 

Before a potential batch user can submit his card deck to the I/O room 
personnel, he must create it by means of the often-frustrating process 
called keypunching. Public keypunches are located in room 201 of the 
Center. (Note: there are far fewer keypunches than one per student 
enrolled in a programming class. Lines get long near the end of the 
term.) Learning to keypunch, especially if you don*t type, is a 
fascinating experience. The quickest way to learn is to try doing 
it. Get help from someone who seems to know how. If all else fails, 
there is a Computer Center publication, "Instruction for Operating 
the Keypunch Machine," available in the basement office, room 126 
(at 10O. 
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10. 

No matter how many cards you may have to punch to get one in the fol- 
lowing form, OS- 3 will not log you on and run your job unless it 
reads* 

gJOB, in columns 1 to 5, followed by your job number, a 
comma, and your user code in columns 6 through 16. 

(Note: the g punch in column 1 is accomplished by holding down the 
multiple punch button while successively hitting the 7 and then the 
8 key.) It is also good practice to punch your name or some other 
identification on the job card, so your deck (and listing) can be 
returned to you by the I/O room staff. 
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11. 

It is important for all batch users to realize the significance of a 

7 7 

o punch in column 1 of a card read by the system. ANY card with a Q 

punch in column 1 is considered to be intended for the OS-3 control 

mode routine: Control is returned to this routine from any subordinate 

level. Thus, those, and only those statements intended for processing 

7 
by OS-3 itself must have a fi punch in column 1. 
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12, 

7 
To LOGOFF a batch run, the system must read: gLOGOFF in columns 1 to 7. 

Batch runs are generally cheaper than on-line sessions since there is 

no "connect-time" in batch, but the advantage of interactive computing 

is lost. Errors which cause the on-line program to revert to OS-3 

control mode, permitting possible recovery, generally cause a batch 

run to aborts that is, QS-£ simply gives up on the job and goes on to 

7 
the next 8 J0B card. 
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13. 

Immediately after logging on we are in OS-3 control mode, as signified 
by the # typed on a teletype, t in the upper lefthand corner of our 
TV screen, or the operating system zipping through our card deck 

n 

looking for a g punch in column 1 if we are running in batch. Two 
important parameters associated with our run are set to the following 
values for us by the system when we log on: 

TIME = 60 seconds or amount remaining on job number, whichever 

is smaller. 
MFBLKS - (maximum disk storage file blocks usable this run) = 
100 or limit associated with job number, whichever is 
smaller . 

If we attempt to use more than 60 seconds of actual computer time 
0S~3 viill interrupt our run and ^rint "TIME GUT" leaving us in control 
mode if we are on-line, aborting our run in batch. If we attempt to 
use more file blocks than are allotted, OS-3 will print "INSUFFICIENT 
FILE SPACE" and take the same actions. 

******** See paragraph 37 for a discussion of file blocks ******** 

If we know at the time we log on that our run should take more - or 
less - than 60 seconds or 100 file blocks, we can override these 
default values by typing in (or including cards with Q in column 1): 

TIME = <some number of seconds > 
and /or 

MFBLKS = <zero to limit on job number > 

Unless his job number is completely out of time, an on-line user may 
simply type: 

TIME = <something larger than current value> (CR) 
followed by 60 (CR) to resume the run from the point of interruption 
following a TIME CUT. After the INSUFFICIENT FILE SPACE message, 
the user types - as two separate commands - 

MFBLKS = < something larger than current value> (CR) 
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and 

GO (CR) 
to resume the run. Batch jobs are aborted , so be certain your values 
are set large enough when you submit a deck for processing. 

Note: All commands entered at a teletype for processing by OS-3 must 
be actually transmitted to OS-3 by pressing CR. From here on in this 
manual we will not continue to write CR after every example, but you 
must actually type it to end each command. 

On-line users can ask the control mode routine how much time or how 
many file blocks have been used, by typing TIME or MFBLKS, omitting 
the "=<value>" portion. The batch user can get the same information 
printed by including corresponding cards . 
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14. 

Associating "logical" unit numbers (LUNs) with physical Input/Output 
(I/O) devices is another function of OS-3. So, before we consider 
descending from OS-3 control mode to some "useful" software, we should 
consider I/O under this operating system. 

********** To bypass this material, skip to paragraph 18 ********** 

All users of OS-3 can output information to the line printer (LP), 
card punch (PUN), plotter (PLOT), high-speed paper tape punch (PTP), 
sequential or random-access disk storage file (FILE or RAF). An on- 
line user can also output data to his Teletype or TV. (PTP is not 
the tape punch on your Teletype . ) 



■ ~ i wi a uxovuooj.uk \sx jjgijj^j.- «.aj^« ) o<s^s pai ugi ayn -r *. 



Input units available to all users are FILES and RAFs. The on-line 
user also has his terminal keyboard, while the batch (and remote-batch) 
user has the card reader for input, and the magnetic tape drives for 
input and/or output. 

******** p or a discussion of remote-batch, see paragraph 45 ******** 

for magnetic tape, paragraph 44 
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15. 

Each user has up to 100 logical I/O devices available. ("Logical 
because several LUNs can be equipped, say, as line printers, although 
there is only one physical line printer. Note also that information 
sent to a "line printer", "card punch", "plotter", or "PTP" is 
actually stored temporarily on disk. So, you can run out of "scratch" 
file blocks although you think you are not using disk at all.) 

7 
A control mode statement of the form ( Q in column 1 for batch): 

7 

gEQUIP,<LUN> = <device type or previously equipped LUN> 

is used to establish the association between a LUN and a physical 
device. 



■S* *& *& iS* <& ^ i& *?!■ 4? ^* 



********** For a discussion of LUNs equipped at LOGON ******** 

in batch, see paragraph 16 
on-line, see paragraph 17 
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16. 

LUNs 60 and 61 are OS-3 T s standard input and output units, respec- 
tively. For batch, this means that, when your job is logged on 
(i.e., when OS-3 reads your "JOB, job number, user code" card), 
LUN 60 is equipped to the card reader, and LUN 61 to the line printer 
All other units must be explicitly equipped while in control mode - 
that is, before starting a run of a library or user program which 
reads from or writes on LUNs other than 60 and 61. Attempting to 
access an unequipped unit in batch causes the job to ABORT . 



ftft*&& Turn to paragraph 4i+ for a discussion of magnetic ******** 
tape use or to paragraph 18 to continue 



16. 



17. 

The on-line user's standard input unit - LUN 60 - is the keyboard of 
his terminal. His standard output unit - LUN 61 - is the printing 
element of his teletypewriter or the screen of his TV. LUN 100 is 
also equipped to the terminal for both reading and writing, and cannot 
be unequipped. Attempting to access an unequipped LUN interrupts the 
running program; the system writes "LUN X UNDEFINED" and leaves 
itself in control mode. The user may then EQUIP the LUN and type GO 
to resume the interrupted program. 
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18. 

All job numbers have associated a third limiting parameter in addition 
to time and scratch file blocks, namely save (able) file blocks. 
"Save" in this context means between runs - between logging off and 
next logging on. To save information presently on a scratch file, the 
user instructs OS-3 to 

SAVE , < LUN> - <NAME> 

where LUN is the logical unit number of the scratch file, and NAME is 
a string of alphanumeric characters, the first alphabetic. Once you 
have saved a file under a name, you may subsequently "equip the file"; 
that is, cause OS-3 to associate a particular LUN with the file by 
instructing the control mode routine to 

EQUIP, <LUN>=<NAME>. 

The data on the saved file may be a program (source, binary, or overlay), 
or may be read by a program (of yours, for example) which reads from 
that particular LUN. When you logoff or otherwise unequip the LUN, the 
saved file survives. But all other LUNs - in particular, all scratch 
files - are unequipped and lost to the user when he LOGS OFF. 

&&*&**&&** See paragraph 38 for more on saved file concepts ********** 

********** Paragraph 19 discusses line printer and card punch ******** 
use from an on-line terminal — to skip this, turn 

to paragraph 21 
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19. 

The on-line user may wish to use the high-speed line printer in the 
machine room of the Computer Center to obtain copies of large amounts 
of information, rather than having this typed out by the much slower 
Teletype. To obtain punched card decks, the on-line user must, of 
course, utilize the system's card punch* In order to permit identi- 
fication of these outputs by the I/O room personnel, a control mode 
command "LABEL" is used: 

LABEL, <LUN>/<message> 
Note: The LUN must first be equipped. 

Example: EQUIP, 40 =LP 

LABEL, HO /SAVE FOR SPIRO 

"SAVE FOR SPIRO" (or any other single-line message as entered by the 
user) will have been printed across the top of the first page of the 
printed listing. The card punch labeling routine punches up to 
eight (8) characters in block letters across one card. If the user 
wishes his punched output interpreted (printed across the top of the 
cards) he might use: 

Example: EQUIP,77=PUN 

LABEL,77/INTERP calls for interpretation of deck 

LABEL, 77/123456 and gives job number to charge to 

LABEL , 7 7 / SMITH user's name 

Information to be written on a LP or PUN is first stored as a scratch 
disk file. When the user unequips the LUN (or LOGS OFF, unequipping 
all LUNs) the scratch file is transferred to a queue (waiting line) 
of files waiting to be punched or printed. At this point, the user 
has his scratch file blocks back and may re-use them. 
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20. 

Suppose you have equipped and labeled a PUN or LP, and have written 
some information on the LUN which you subsequently do not wish to 
output. Clearly, unequipping the LUN will have the reverse effect - 
the bad information (technical term: "garbage") will be output 
immediately (as far as the user is concerned) if the LUN is unequipped 
Instead, the RELEASE command is used to return the file to an empty 
configuration (including label) so that nothing is output when the 
LUN is unequipped. 

Form: RELEASE, <LUN> 
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21. 

Further information about commands recognized by the OS- 3 control mode 
routine may be found in the "OS-3 Reference Manual", ccm-70-8R, July, 
1971. We now contemplate a descent from OS-3 control mode to some 
subordinate level of software. How might we categorize these sub- 
ordinate levels? 
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22. 

There are library programs, which can be called by typing a single key 
word, sometimes followed by a string of parameters. These include the 
language translator programs: ALGOL, BASIC, COMPASS, FORTRAN, OSCAR, 
RADAR, and COBOL. Information for each of these is available in 
separate documents. (See Appendix A.) 
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23. 



Next, there are utility programs called directly from OS-3 control 
mode: COPY, COSY, DIRECTORY, DUMP, EDIT, LABEL, and LOAD. 

COPY - Copies information from one file, LUN, or media to 
another. Documented in OS-3 Reference Manual, ecm- 
70-8R, page 20. 

COSY - Local version of CDC's Compressed Symbolic Editor for 
compressing stored information. See manual ccm-70-6. 

DIRECTORY - Prints list of user's saved file names as of 

previous day. Written up in OS-3 Reference Manual, 
ccm-70-8R, page 27. 

DUMP - Core dump routine, see OS-3 Reference Manual, page 28. 

EDIT - An on-line (only) editing routine for creation and 
alteration of files. Separate manual ccm-70-7R. 

LABEL - See paragraph 19, this manual, or OS-3 Reference 
Manual, page 39. 

LOAD - Loads relocatable "binary decks" - pseudo object 
language programs in relocatable form, see OS-3 
Reference Manual, page 41. 

The execution of any of the options mentioned here or in paragraph 22 
DESTROYS the status of a previously interrupted program: It cannot 
be restarted by typing GO. 
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24. 

The remaining commands recognized by the OS-3 control mode routine 
are principally file manipulation and status changing or checking 
commands. Consult the OS-3 Reference Manual for further details. 
Note that these remaining commands are processed directly by the 
control mode routine; your interrupted program is not clobbered by 
execution of the command 5 and so may be restarted with a GO. 
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25. 

Examples given in a manual such as this are often misleading, inade- 
quate, confusing, and/or out-of-date. Such an example follows: 

(caveat emptor) 

The user cautiously approaches the 

" Hi '« Keypunch, turn to paragraph 26 ***** 

***** Teletype, turn to paragraph 27 ***** 

***** TV, turn to paragraph 33 ***** 
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26. 

sits down, turns the keypunch on, waits for it to warm up, feeds and 
registers a card, and types 

Col. 1 

g JOB, 123»* 56, USER, SAVE FOR SPIRO 

gTIME=15 

gFORTRAN,L,X 

77 
88 

The double 7,8 End-of-File card is required to set up a successful 

7 
exit from the compiler. If the system should read a g<command> card 

instead, control would immediately be taken away from the compiler 

and the final subprogram would not be completely compiled. 

Continuing the example now; the user might 
gDELETE,BINDECK 
gSAVE,56=BINDECK 
gEQUIP,l=INFILE 
gLOAD,56,SUBPROGl,SUBPROG2,L=MYLIBR 

Col. 1 RUN 
gLOGOFF 

Having punched and checked all these cards, the user takes the deck 
to the I/O room (CC 207), fills out a cover card, and submits the deck 
as a batch job. 
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Let's surmize what we can about this program, even though the source 
decks are not shown. First, it is expected to be a short run - no 
more than 15 seconds. The user wants a listing of the source decks, 
and wants the binary (object) decks written on LUN 56 (by default). 
He remembers the VL card following his final source deck. Apparently 
he had saved a binary deck as a saved file at some prior time, and 
now wishes to save the new binary output from the compiler under the 
same name - D±hi)z*\,]\ \o± course me vx^ j.iuormdi.4.wu wj.j.j. *•*= -. v &-,. 

He then sets up the I/O units for the actual running of his program. 
The program presumably reads data from LUN 1. He equips this LUN to 
a saved file named INFILE. (Of course, we cannot be certain that the 
program does not write on INFILE . It could . ) 

Now he is ready to load and run his program. But it apparently 

_• j _..i ~i, .J-. ,'„ K,*«=» w . -P^-^Tr, QTmDPflCI anH SITRPR0G9 

requires IWO SSUJjpi.'Ugl.'a.JUS axicau^y J.ii wa.nai_y iwimj u/v«* iiwj-. v***** w~~-- — 

plus one or more additional programs from a library called MYLIBR, 
The loader hopefully will get all of these programs loaded into the 
user's 32,768 words of memory, then come back to read the LOADER 
control card 



Col. 1 

f" [Note: NO g punch] 



"RUN 1 



The loader will then give control to the user's main program. Almost 
any error occurring during the actual run will cause the job to abort, 
so it behooves the batch user to be very thorough in checking out his 
programs and the overall structure of the deck he submits. 



****** The Teletype example follows. To skip it, turn to ****** 

paragraph 32 
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27. 

sits down, turns the knob above his right knee to the "LINE" position, 
pushes CNTL and A at the same time, and observes the # typed by OS-3. 
He then enters 123456, USER and pushes CR. OS-3 approves of this job 
number/user code combination, and types out the date, time, and 
terminal number, and then another #, its trademark. The user is 
logged on. He wishes to create a source program, save it as a file, 
then compile, test, and run it, and have its output printed on the 
line printer in the machine room. 

First, to create the source program, he calls the editor, by typing 
EDIT (CR). 

The editor responds with its special symbol, "3" and the user knows 
he is in edit command mode , To begin a new body of text in the 
editor's work area, he types INPUT (CR), and the editor responds with 
a line number 

001: 
The user then enters the first line ("card") of his source code. 

001: PROGRAM DEMO 

followed by a CR, and the editor types out the next sequence number 
and waits for another line , etc . 

Question: How to get out of input mode, back to edit command mode 
( not OS- 3 control mode)? 

Answer: Type either ESCape, ALTMODE, or CNTL and W. 

Question: How to get out of the editor completely, i.e., back to 
OS-3 control mode. 

Answer: CNTL-A or BREAK or the edit command "EXIT". 

Question: How to get back to the editor from OS-3 control mode 

without destroying what you've already done with edit. 

Answer: Do NOT type EDIT. This would give you a fresh copy of 
the editor, clobbering what you had already typed in. 
Instead, type MI (for "Manual Interrupt"). 
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28. 

The same concept applies if you were in OSCAR or BASIC, and got 
returned to OS- 3 control mode. MI will put you back into the command 
level of the interrupted program without clobbering anything. 60 
will resume execution of your program, or continue an edit or I/O 
operation that was in progress when the control mode interruption 
occurred . 



****** Continue reading paragraph 29 to complete the teletype ****** 
example. Otherwise turn to paragraph 31 
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29. 

Having typed in the last line of his source code, the user wishes to 
escape from EDIT's input mode back to its command mode, and so types 
either CNTL-W, ALT MODE, or ESC. (All teletypes have a C'NTL key and 
a W.) 

The Editor once again responds with its symbol "]" . The user must 
then cause the editor to write the text he has typed into its work 
area on disk, for reading later by the FORTRAN compiler. The editor 
can write in three different formats (BCD - "Binary Coded Decimal" 
is a particular code used by the CDC 3300): 

1) variable or fixed length BCD records (OUT command) 

2) compressed BCD (FILE command) 

3) COSY (COUT command) 

Since COSY output is the most compressed, requiring the least disk 
space, the user chooses to use- 

3C0UT,DEM0 

If no saved file named DEMO existed, one is created and the contents 
of the edit work area are written on the file in COSY format. The 
user now has a saved file named DEMO with a FORTRAN source program 
named DEMO written on it. The choice of the program and the file 
names are arbitrary: they need not be the same. 

The next step is to try compiling the source code. If the user 
wants the compiler to provide a printed listing, he may have this 
typed on the teletype by including the L parameter in the calling 
statement . 

Most FORTRAN listings are too long for an impatient TTY user, so it 
is common practice to "send" such listings to the line' printer . This 
is done by 

EQUIP, <lun>=LP 
say EQUIP, 5=LP 
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If he then calls FORTRAN - the other compilers or assemblers are 
called in an analagous manner - with, for example 

FORTRAN, I=DEM0,L=5 
the text will he written on an unlabeled listing which will be dif- 
ficult to recover from the I/O room. Instead, after equipping the LP 
he should 

LABEL, 5 /SAVE FOR SPIRO 
and then use the compiler. 

If the compiler detects syntax errors in the source statements, the 
user may fix the source program by calling EDIT, then reading the 
COSY records into the edit work area by typing "FIN, DEMO" . He may 
list, change, insert, and delete lines, and then rewrite the infor- 
mation to disk with another COUT command. Presumably the listing 
created by the first compilation is unwanted. The user should 
RELEASE, 5 rather than unequipping it, then (re) LABEL, 5 /SAVE FOR 
USER, and call the compiler again. 

Suppose this time there are no: errors detected. The user then has a 
"clean" listing available for printing when he unequips 5 or logs off. 
But he has no runable machine code - no "object program" or "binary 
deck". To get the compiler to produce this additional output, the 
user should have included either the X parameter, which causes the 
compiler to write (on LUN 56) relocatable binary records logically 
equivalent to the FORTRAN source, or the R parameter which causes 
the same output on 56, followed by a BCD record "RUN", followed by 
a direct call to the loader. Thus the R parameter causes a "load- 
and-go" run of the object code. (If separately compiled subprograms 
or non-standard libraries are to be used, the R parameter method will 
not work. The user must supply an explicit call to the loader in 
this case.) 
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Let us suppose the user has some subprograms already compiled into 
"binary deck" relocatable form, and/or a (non-standard) library he 
wishes to load subprograms from. He therefore has used the X para- 
meter in his compiler calling statement: 

FORTRAN, I=DEM0,L=5,X 

The compiler has read the source program statements from the saved 
file named DEMO, written a listing of these on the line printer (LUN 5), 
and written relocatable object code on LUN 56. The user may now call 
the loader: 

LOAD ,56, SUBPR0G1 , SUBPR0G2 , L=MYLIBR 

His main program from LUN 56, the two subprograms, plus anything else 
needed from MYLIBR, then the standard FORTRAN library will be loaded 
and linked together to operate as one large program. Control will 
then be passed to the user's main program, and it will do its thing. 
A message "END OF FORTRAN EXECUTION" will be typed when (if) the 
program makes a normal exit back to OS-3. Otherwise, some other 
message will appear and the user will be returned to OS-3 control 
mode . 
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For instance, suppose the user has not changed the time limit of 60 
seconds set for him by OS-3 at LOGON. After running the user's job 
- including edit and compiler time - for 60 seconds, OS-3 will inter- 
rupt the user's object program, print "TIME CUT", and leave the user 
in control mode. 

Question: What to do? 
Answer: See paragraph 13 
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There are, of course, zillions of things that might go wrong during 
the execution of the user's program. No publication is long enough 
- no author clever enough - to think of them all. If your program 
blows up in a manner which remains mysterious to you, although you 
have checked the references and asked all your friends, the Computer 
Center provides a staff consultant during school terms , weekday 
afternoons from 1 to 4 o'clock in CC room 211. 
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sits down, clears the screen, and observes that the cursor - left end 
of string of dashed lines - is in the upper left-hand corner of the 
screen. The user then types i (upper case 7) followed by his job 
number/user code, and pushes SEND. If the number was valid, OS- 3 
clears the screen and writes the date, time, and terminal number; the 
user is now logged on. Suppose he wishes to do the same things the 
TTY user did (see paragraph 27). The TV user also calls the editor 
by typing EDIT, but he may think in terms of screens-full, rather 
than by line. For example, after noting the 3 in the upper left-hand 
corner (the editor ! s trademark), the user might type "INPUT" and then 
push the RETURN key (to drop the cursor down to the next line) and 
begin entering text . 

fTVua n?T'o "hn-F-F^tn >>r\1^e D linoe oao>> t; n /->"ha-r>a r.+-ono 1 <~vt-io- ^ A-F-f-e»v> 

entering as many lines as desired (£20), the user presses SEND, and 
the entire buffer full of text is transmitted to the editor T s work 
area in main memory of the CDC 3300. If more text is to be added, 
the APPEND command must be used, rather than INPUT. (Otherwise the 
first input will be clobbered by the second, etc.) 

After entering all the text, the user may have it listed, a screenful 
at a time, by typing LIST, followed by repeated SENDs . Insertions, 
deletions, and replacement of lines is accomplished in essentially 
the same manner as on the TTY. For further details about the editor, 
consult ccm-70-7. 

Question: How to get into OS- 3 control mode from edit on a TV? 

Answer: Clear the screen, type ^, and SEND. You are then in 
control mode. 

Question: How to get back to edit from OS-3 control mode? 

Answer: Clear the screen, type MI, and SEND. 
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*** See paragraph 28 for a comparison of MI and GO ********** 

or paragraph 34 to complete the manual. 
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This is the end of the primer. The paragraphs which follow represent 
branches you night have taken during your travels through the text. 
Please take a few minutes to complete the following critique. 



1. This manual is: Very good 

Good 
Fair 
Poor 
Terrible 

2. It would be better if: 



The following items should be covered: 

a) but are omitted 

b) more thoroughly 

c) less thoroughly 

d) not at all 



Please return this - in a plain brown envelope, if you like - to the 
Computer Center, ATTENTION: Publications Committee. 
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35. 

Job numbers are obtained in room 126 in the basement of the Center: 
Phone 2494. 

OS-3 operates on a pay-as-you-go basis. The key for any user is $$ 
- TIME is money. Unsponsored research grants are sometimes available 
to destitute but worthy students (usually graduate students) and 
faculty members. Staff members may use grant or departmental funds. 
Once it has been determined that a job number is to be issued to you, 
the Center will assign the number, you may select the four-character 
user code, and the system will honor the combination the following day. 

The three parameters associated with each job number/user code are: 

TIME = total number CPU seconds authorized 

"Scratch" File Space = amount of disk storage space usable 

during one run (exclusive of Save File Blocks) 
Save (able) File Space = amount of disk storage you may occupy 

between LOGOFF and next Logging ON. 



**&******& Paragraphs 36 and 37 discuss costs and billings ********* 
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Usage of the system is measured in $$ and converted to equivalent 
CPU (Central Processing Unit) time. 

CPU TIME costs $5 /minute =81/3 cents per second. Terminal connect 
time is $2 /hour. Disk storage space is 15 £ per file block per month. 
(See next paragraph for "What's a file block?") It costs 15$ to read 
100 cards; 25$ for the card punch ( not a keypunch) to punch 100 cards, 
The line printer sells for 12 1/2 cents per 100 lines. 

Accounting is done in dollars and cents and the time equivalent 
adjusted accordingly. Thus, if you LOGON with 100 seconds on your 
job number, use 10 seconds of CPU time, 1/2 hour of terminal time, 
use the line* printer or punch, etc., then logoff and logon again, you 

ina.y uriu tiicit you nave unxy /o acuunus ui lxuk jlcx u . xw^xvc -uj. cii& 
15 mystery seconds cover the $1 charge for the 1/2 hour terminal 
hook-up. The remaining 3 seconds must be for lines printed on the 
printer or cards punched by the system's card punch, etc. It is even 
possible to wind up with negative seconds - the 4th dimension at OSU. 

Detailed summaries of the amount of each resource used during each 
run can be obtained with the monthly billing. 

To get more time ($) added to your number, call or visit the office 
mentioned in paragraph 35. 
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A file block is a measure of physical disk storage. One file block 
is equivalent to 510 words of CDC 3300 core storage. Data is read 
and written in units called records. Each record may contain the 
same number of words, ("fixed-length" records) or the number of words 
per record may vary ("variable-length" records). In either case, 
OS- 3 uses an extra word at each end of each record to tell how long 
the record is. So, for example, if your job number has a scratch 
file block limit of 50 file blocks, and you want to compute the number 
of card image records this represents, the numbers are as follows: 

510 words/file block X 50 file blocks = 1153 recor a s 
20+2 words/records 



As a second excunple, Suppose your job numbex- has a save iilc bxOCK 

limit of 10. Then you may create a maximum of 9 empty saved files - 
the 10 is an upper bound not actually attainable, and each saved 
file name charged to your job number/ user code deducts one from your 
available number of save file blocks. A non-empty saved file - one 
with at least one record - takes up at least two file blocks: the 
automatically used one plus at least one more for the actual data 
records . 
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The name that a file is saved under is significant. If the first 
character of the name is anything other than * or + , then the file 
is "private" and is accessible only to the job number/user code com- 
bination that created it. 

A file whose name begins with t is accessible by any user code under 
the job number which created it, while a file whose name begins with 
* is accessible to all users of the system. + files are called 
"semi-public" or "semi-private" depending on the optimism of the 
describer. * files are called "public" and should be "file-protected". 
That is, made read-only (non-writeable) by using the control mode 
command FP,<name>. The command RFP may be used to remove file pro- 
tection if the file was created under the same job number, user code. 

File blocks in use are billed at 15$ per block per month. 

Question: How to unsave a saved file? 

Answer: The command DELETE ,<name> will dispose of an unprotected 
saved file. 

The command DESTROY ,<name> will eliminate any private 
file (which belongs to the user, of course) even if it 
is file protected. 

Only the creator of an + or * file can remove file 
protection. 
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Programs to do almost anything reasonable have been written by someone 
or other and may be available as overlays or as binary and/or source 
decks on saved public files. A "complete" list of these may be found 
in the Center's Program Library Catalogue, ccm-70-27, September, 1970. 
Changes too recent to appear in this volumn are on a public file, 
"LIBRARY with the most recent updates first. This file may be 
copied at a TTY or TV, or out to a LP. 

Some programs are documented in separate manuals : 

Examples include: 

SORT ccm-71-06 
and MERGE ccm-70-17 
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Overlays are called from OS- 3 control mode by simply typing the name 
of the file the overlay is saved on. That is, if the control mode 
routine is given a command which is not in its vocabulary, it searches 
the file directory, and, if a saved file with the same name is found, 
OS-3 attempts to load the file as an overlay. An overlay is a program 
in absolute, nonrelocatable machine code, created by a call to the 
loader of the form: 

LOAD , <LUNS> , <FILES> , <LIBRARIES> , = <overlay name> . 
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41. 

For example, *SC00P contains an overlay which prints out the time 
remaining on the user's job number. *LL prints a list of currently 
equipped LUNs. *ASSEM is the new 3300 assembler, etc. Many public 
overlays of this type exist from moment to moment at the whim of 
their creator. Those which are documented in the Program Library 
Catalogue are under the control of the Center, and so will probably 
exist when you want to use them. Others, contributed by private 
individuals, are largely undocumented, must be learned about through 
hearsay, and used at the user's risk. 
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Paper tape may be copied to a file at relatively high speed by sub- 
mitting the tape to the I/O room personnel, so that they may have it 
read by the reader attached to the PDP-8. The cost is 25$ per 100 
input blocks, 1 input block a 62 characters. Such data must then be 
massaged into the 3300 f s internal code by available software. Contact 
Ron Davis (Room 224B, phone 2494) or the I/O room personnel for 
details. 
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Data may be copied out to the high-speed paper tape punch on the 
PDP-8 by equipping a LUN ~ PTP, and labeling the LUN with *PTLABEL 
Such data is first written as a scratch file, and so may generate 
an INSUFFICIENT FILE SPACE message. 
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There are four magnetic tape drives attached to the system at present. 
Normally these are accessible only to batch and remote-batch (see 
paragraph 45) users. To equip a LUN to a tape drive, include a card 
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1 EQUIP, <LUN>=MT<number> AT <density><comments> . 
8 



NOTE: The blanks delimiting the word "AT" are required. Density may 
be specified as 200, 556, or 800. Comments usually include 
whether the tape should be write-enabled , and perhaps some fur- 
ther identifying information to reduce the probability of 
operator error. No software checks of tape labels, etc., are 
made by OS-3. If you desire label checking you must write 

yvui unit wwv*>« • 
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A remote terminal user may avoid the $2 /hour connect charge, and/or 

utilize the. magnetic tape units by setting up a simulated batch job 

from his terminal. He must create a file of card images which look 

7 
exactly like regular batch cards, except that the g punches are 

replaced by left bracket, [. This is most easily done with the 

editor. For example, to set up a remote-batch run of the binary 

deck saved in the batch example, paragraph 16, the user might logon 

and call EDIT, then type 



3 INPUT 

001 

002 

003 

004 

005 

006 

007 

008 

009 



[JOB, 123456, USER, SAVE FOR SPIRO 

[TIME=200 

[MFBLKS=500 

CLOAD,BINDECK,SUBPROG1,SUBPROG2,L=MYLIBR 

RUN 

C DELETE, 0UTFILE_ 

E SAVE, 41= QUIT ±Lt; No *Lun is not a file 

[LOGOFF 

ESC 



Note: Typing ESC, or ALTMODE, (or SEND on a TV) gets us back to the 
editor's command mode. 

We now must OUT the text to a special type of file called a TASK, 
which OS- 3 will subsequently treat as a batch card deck submitted in 
the normal way. 

This text, currently in the editor 's work area in core storage, is 
to be written out to a TASK unit in card image format. The correct 
editor command is 

OUT, TASK 

The TASK is automatically unequipped and the card images join a queue 
of remote batch decks. From then on, the job is processed as a batch 
job. All LUNs are equipped as in batch, the same errors abort the 



45 



job, etc. Output for LUN 61 will go to the line printer in Corvallis. 
Really remote users who may later want to copy the output from such a 
job to their TTYs should define LUN 61 as a saved file. This can be 
done in a special way by putting 

61 = <NAME> in the JOB card. 

Example : 

[JOB, 123456, USER, 61 = PRNTFILE,SAVE FOR SPIRO . 

Records normally printed will instead be written on the saved file 
PRNTFILE up to the user's save file block limit . If this limit is 
exceeded, the job will abort. 

We have just OUTed our TASK, and are still logged on at the terminal. 
A CNTL-A (or CLEAR,/, SEND on the TV) will put us in OS-3 control mode 
so we can LOGOFF, If we remain logged on at the terminal, we must be 
certain that none of the saved files used by the remote batch job are 
also equipped by the on-line job. Otherwise the remote batch job 
will abort with a message about "FILE BUSY". A way to make sure no 
files are still equipped is to use the 'RESET 1 command in the editor 
before OUTing the file. 
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OS- 3 runs on a hardware configuration which consists of a Control 
Data 3300 and a Digital Equipment Corporation PDP-8, a much smaller 
computer which interfaces the 3300 with assorted Teletypes and 
handles the high-speed paper tape punch and reader. 

A "bit" or binary digit is the fundamental unit of information in a 
digital computer. Each bit answers a single yes-no, off -on, one-zero 
question. In the 3300, PDP-8, and most contemporary machines, "bits" 
are implemented in hardware in the form of ferrite cores - tiny 
doughnut shaped ceramic rings with a magnetic iron compound which 
gives the core the properties of a magnet. Thus, when magnetized in 
say the clockwise-is-north direction, the core may represent 1; when 
magnetized oppositely it represents . 

Since one bit is a very small amount of information, most computers 
work with larger collections of bits called "words". Each word in 
the CDC 3300 is 24-bits long. Each quarter-word or 6 bits is called 
a "character". Core memory may be accessed one or two words at a 
time, or one character at a time. The 3300 uses the 6-bit binary 
coded decimal (BCD) code to represent characters internally. 

Many users are able to use the resources of the system seemingly 
simultaneously because core memory of the 3300 is divided into blocks 
called "pages" of 2048 words each. Only one page of a given user's 
program need be in physical memory of the machine for that user's 
program to be run - at least partially. The remainder of his pages 
may be kept on a disk file , and swapped in and out of core storage 
as needed. In fact, if the load on the system should become so great 
that not even one of a given user f s pages can fit in core, that job 
may be "delayed" - all the pages left on disk for a time. The job 
is said to be "swapped out". 
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Each user has access to at least 16 pages, or 32,768 words, of 
"virtual" memory, as contrasted with actual physical core memory 
of the 3300. The operating system, OS-3, gives each job a quantum 
of time to run, then passes control of the computer to the next 
active job. Cycling around this circular list of jobs, QS-3 is 
usually able to provide sufficiently quick response so that each 
user thinks he has the system pretty much to himself. 



46.1 



jari'HiiNUiA j\ 



APPENDIX A 



Other Computer Center Publications: 



Title 

OS-3 Reference Manual (Revised July 1971) 

OS- 3 Editor Manual 

Brief Description of OSCAR (4th revision, Jan. 71) 

EZPLOT 

RADAR 

Sort /Merge for OS-3 

COSY for OS-3 

Program Library Catalog 

FORTRAN: Entering, Editing, and Running from 
Remote Units. under OS-3 

Note that the principal reference for FORTRAN, 
as well as for COMPASS, COBOL, and ALGOL, is 
the appropriate Control Data Corporation publi- 
cation. These are also available for purchase 
in CC 126. 

A complete set of Computer Center publications is on display outside 
the office (CC 126) in the basement of the Center. 



Number 

ccm-70-8 

ccm-70-7 

ccm-69-25R 

cc-69-18 

ccm-70-9 

3 3— 68 — 37R 

ccm-70-6 

ccm-70-21 

ccm-68-39 
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INDEX 



BATCH 

Logging On in Batch, 10 

OS- 3 Control Mode in Batch, 11 

Logging Off a Batch Run, 12 

LUNs Automatically Equipped in Batch, 16 

Batch Example, 26 
BATCH USER 

Batch User Defined, 3 

Keypunching: Batch User f s Delight, 9 
CARD PUNCH 

Line Printer/Card Punch Use from On-Line, 19 
CDC 3300 

Time-Sharing on the CDC 3 300/PDP-8; System Architecture, 46 
COMPILING 

Compiling a Program Created with EDIT, 29 
CONTROL MODE 

OS-3 Control Mode in Batch, 11 

Other Control Mode Commands, 24 

OS-3 Control Mode as Seen from a TV, 8 
CRT 

TV (CRT) Terminal Use, 7 
EDIT 

Teletype Example, Editor Reference; to and from EDIT from OS-3, 27 

Compiling a Program Created with EDIT, 29 
EQUIP 

I/O Units and Logical Unit Numbers (LUNs); the EQUIP Command, 15 
EXAMPLE 

Batch Example, 26 

Teletype Example, Editor Reference; to and from EDIT from OS-3, 27 

TV Example, 33 
FILE 

File Naming Conventions, 38 
FILE BLOCKS 

Saving Information on Disk; Save File Blocks, 18 
INPUT 

Input/Output (I/O) Units, 14 
INTERRUPT 

Manual Interrupt (MI) Versus 'GO 1 , 28 
JOB NUMBERS 

Job Number Parameters: TIME and MFBLKS, 13 
KEYPUNCHING 

Keypunching: Batch Use^s Delight, 9 
LABEL 

The LABEL Command, 19 
LIBRARY 

Library Programs, 22 
LINE PRINTER 

Line Printer/Card Punch Use from On-Line, 19 
LOADING 

Loading and Running the Compiled Program, 30 
LOGGING OFF 

Logging Off a Batch Run, 12 

Logging Off at a Teletype, 6 



LOGGING ON 

Logging On in Batch, 10 

Logging On at a Teletype, 5 
LUNs 

I/O Units and Logical Unit Numbers (LUNs) The EQUIP Command, 15 

LUNs Automatically Equipped in Batch, 16 

LUNs Automatically Equipped - Terminal Users, 17 
MAGNETIC 

Magnetic Tape, 44 

Remote Batch: Magnetic Tape Use from a Remote Terminal, 45 
MFBLKS 

Job Number Parameters: TIME and MFBLKS, 13 
MI 

Manual Interrupt (MI) Versus 'GO', 28 
ON LINE USER 

On-Line User Defined, 4 
OPERATING SYSTEM 

Operating System Defined, 1 

OS- 3, A Time Shared Operating System, 2 
0S-3 

OS-3 Control Mode in Batch, 11 

QS-3, A Time-Shared Operating System, 2 

Reference to OS-3 Reference Manual, 21 

Teletype Example, Editor Reference; to and from EDIT from OS-3, 27 

OS-3 Control Mode as Seen from a TV, 8 
OVERLAYS 

Overlays, 40 

Examples of Useful Overlays, 41 
PAPER TAPE 

Paper Tape: High-Speed Processing Via the PDP-8 , 42-43 
PDP-8 

Paper Tape: High-Speed Processing Via the PDP-8, 42-43 

Time-Sharing on the CDC 3300/PDP-8: System Architecture, 46 
PROGRAMS 

Library Programs, 22 

Program Library - 'Canned* Programs Currently Available, 39 
QUESTIONNAIRE 

End of Primer - Questionnaire, 34 
REFERENCE MANUAL 

Reference to OS-3 Reference Manual, 21 
RELEASE 

The Release Command - Suppress Unwanted Output, 20 
REMOTE BATCH 

Remote Batch: Magnetic Tape Use from a Remote Terminal, 45 
SAVE 

Saving Information on Disk; Save File Blocks, 18 
TAPE 

Magnetic Tape, 44 

Remote Batch: Magnetic Tape Use from a Remote Terminal, 45 
TELETYPE 

Teletype Example, Editor Reference; to and from EDIT from OS-3, 27 

Logging On at a Teletype, 5 

Logging Off at a Teletype, 6 
TERMINAL 

LUNs Automatically Equipped - Terminal Users, 17 

TV (CRT) Terminal Use, 7 
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Job Number Parameters: TIME and MFBLKS, 13 
TIME-SHARING 

Time-Sharing on the CDC 3300/PDP-8: System Architecture, h6 
TV 

TV Example, 33 

TV (CRT) Terminal Use, 7 

OS- 3 Control Mode as Seen from a TV, 8 



